﻿@{
    Layout = "~/_ContentLayout.cshtml";
}

@section headerBody {
    <h1>Installing Boxstarter</h1>
    <p class="lead">Boxstarter can be installed using <a href="http://chocolatey.org">Chocolatey</a> or by downloading the Boxstarter zip file and running Setup.Bat</p>
}

<p>NOTE: If you simply want to install a "one-off" script locally on a machine, you may find it easiest to <a href="weblauncher">launch Boxstarter from the web</a>.</p>
<h3>Prerequisites</h3>
<p>Boxstarter requires the following to work:</p>
<ul>
    <li>OS: Windows 7 or Windows Server 2008 R2 and higher</li>
    <li>PowerShell Version 2 or higher</li>
    <li>Administrative privileges on the machine where Boxstarter is running</li>
</ul>

<h3>Installing from Chocolatey</h3>
<pre>
CINST Boxstarter
</pre>
<img src="images\installed.png" />
<p>This will download and install the Boxstarter modules to your PSModulePath.</p>
<h3>Downloading the zip file</h3>
<p>The zip file contains a Setup.Bat file that will go to Chocolatey and install Boxstarter. If Chocolatey is not installed on your machine, the Boxstarter installer will request the user's permission to install it. Note: Setup.bat accepts a <code>-Force</code> argument to suppress this prompt.</p>
<img src="Images/setup.png"/>
<p>Boxstarter is now installed in your modules path!</p> 

<p>Both the Chocolatey Boxstarter package and the downloaded zip file available on this website install all Boxstarter modules except the Boxstarter.Azure module which provides integration with Windows Azure VMs. You can install the Azure module by running <code>CINST Boxstarter.Azure</code>. In addition to the Boxstarter.Azure module, it also installs the Windows Azure PowerShell toolkit, the Azure SDK for .Net Libraries and .Net 4.5. It requires PowerShell 3 or higher (the version installed with Windows 8/server 2012 and higher but also <a href="http://www.microsoft.com/en-us/download/details.aspx?id=40855">freely available for download</a> on older versions) to install successfully.</p>

<p>After Boxstarter is installed, a new PowerShell console must be opened before you can load the modules and run its commands. For convenience you can use the <a href="/UsingBoxstarter">Boxstarter Shell</a> for running Boxstarter commands which is the easiest way to ensure that all Boxstarter modules are properly loaded regardless of the version of Windows and PowerShell you are running.</p>